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f " FIG. 2 

1 /* simplified algorithm for a Collection Extensible Action GUI 7 

2 Receive a request to execute a GUI action 

3 Obtain action definition from action data storage means 

4 Execute the requested action according to stored action data 

5 Display execution results on display screens, in computer files, etc. 
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FIG. 4 



1 /* simplified algorithm for a Module Action Request Manager */ 

2 Receive action execution request (e.g. from menu or button click) 

3 Get action identifier from incoming action execution request 

4 Get action definition from executable action data storage means 

5 Execute requested action according to executable action definition 

6 Output action execution results on display screens, etc. 
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FIG. 6 

1 /* simplified algorithm for Module Execute Action Manager */ 

2 Determine requested action type (single or group action) 

3 If requested action is a group action, call Execute Group Action 

4 - Loop to execute group action, calling Execute Single Action 

5 If requested action is a single action, call Execute Single Action 



FIG. 7 

1 /* simplified algorithm for Module Execute Group Action */ 

2 Loop over all single actions in the group 

3 Call Execute Single Action for each action in turn 
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FIG. 9 

1 /* simplified algorithm for Module Execute Single Action 7 

2 Substitute focus variables into action command templates 

3 If action type = internal, call Execute Action Command Internal 

4 If action type = external, call Execute Action Command External 

5 If action type = fvar-op, call Execute Action Focus Variable Operations 

6 Calculate dynamic list if required by a dialog 

7 If action type = dialog, call Execute Action Dialog 
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1 /* GUI action request data structure */ 

2 request-info { 



4 

5 } 



+ action-identifier 

+ other optional request information, if desired 
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1 


name-action.tbl: 




2 


# action names and their definition files 


3 


# name 


definition-file 


4 


# 




5 


a-coll-file-edit 


a-coll.def 


6 


a-coll-file-new 


a-coll.def 


7 


a-coll-file-open 


a-coll.def 


8 


a-coll-file-save 


a-coll.def 


9 


a-build-and-export 


a-action-misc.def 


10 






11 


a-focus-coll 


a-focus-coll.def 


12 


a-focus-repository 


a-focus-repository.def 


13 


a-focus-prev-role 


a-focus-prev-role.def 


14 




15 


a-display-message 


a-action-misc.def 


16 


a-file-cmd-dir 


a-action-misc.def 


17 


a-edit-find-and-replace 


a-action-misc.def 


18 






19 


a-filename-set 


a-action-vars.def 


20 


a-pathname-set 


a-action-vars.def 


21 


a-coll-select 


a-coll.def 


22 


a-coll-build-and-install 


a-coll.def 
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1 # The format of an action definition is shown below: 



2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 



15 
16 
17 
18 



21 
22 
23 
24 
25 



13 # 

14 # 



action 

action-desc 

action-type 

action-cmd-aname 
action-cmd-dname 
action-cmd-iname 
action-cmd-xtext 

action-pcmd-xtext 

action-pcmd-aname 

action-pcmd-wait 

action-var-dirname 
action-var-filename 
action-var-varname 



19 # 

20 # 



action-ifile 
action-odisplay 
action-ofile 
action-ofile-save 



# 
# 
# 
# 

# end-action 



<action name> 

<one line text description> 

<action type = SINGLE, GROUP> 

<action name for group actions> 
<dialog name> 
internal subroutine name> 
<external cmd text> 

<execute a command in parallel 
<execute a single action in parallel 
<wait for prev parallel exec block to finish> 

<left side (dirname) of pathname> 
<right side (filename) of pathname> 
<variable name> 

<input filename> 

<display method = popup/galley/none> 

<output filename> 

<save output file - yes/no> 
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36 



a-action-misc.def: 

# some example actions and their implementations 
# 

a-display-message 
display a message in a text box 
single 

callback-text-display 
"Creating customized files now.. 



action 
action-desc 
action-type 
action-cmd-iname 
action-cmd-text 
end-action 
# 

action 

action-desc 

action-type 

action-cmd-iname 

action-cmd-xtext 

action-odisplay 

end-action 

# 

action 

action-desc 

action-type 

action-cmd-iname 

action-cmd-dname 

action-cmd-text 

end-action 

# 

action 

action-desc 

action-type 

action-cmd-iname 

action-cmd-xtext 

action-cmd-xtext 

action-cmd-xtext 

action-cmd-xtext 

# 

end-action 



a-file-cmd-dir 

run the "dir" command and display output 
single 

callback-xcmd 
"command.com /c dir" 
win-galley 



a-edit-find-and-replace 

run a program to find and replace strings 

single 

callback-fvar 
dialog-find-and-replace 

"changeme "@{old}" "@{new}" -files "©{files}" 



a-build-and-export 

generate makefile, build, and export a program 
single 

callback-platform 
"makefiiemagic -outfile makefile" 
"make all" 
"make exports" 
"make clean" 
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1 


a-action-vars.def: 






2 


# some example actions that work with variables 




3 


# 






4 


action 


a-pathname-set 




5 


action-desc 


put user pathname into a variable 




6 


action-type 


single 




-7 
I 


action-cmd-iname 


callback-var-set 




8 


action-var-varname 


var-user-pathname 




9 


action-var-value 


c:/some/dirname 




10 


end-action 






11 


# 




s = H 


12 


action 


a-filename-split 




13 


action-desc 


split pathname into dir and filename parts 


:« S 


14 


action-type 


single 


sy 


15 


action-cmd-iname 


callback-var-split 




16 


action-var-varname 


var-user-pathname 




17 


action-var-dirname 


var-user-dirname 




18 


action-var-filename 


var-user-filename 




19 


# 






20 


end-action 




; sss a 

1=6 
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■i 
1 


# some example 


focus variable names and their values 




Z 


# name 


substitution-value 




3 


# 






4 


cfg-cust-ctx 


default 




5 


cfg-cust-dir-cust 


c:\codefast\version\site 




6 


cfg-cust-dir-inst 


c:\codefast 




7 


cfg-cust-inst-type 


cf-both 




8 


cfg-cust-platform 


win2000.plt 


0 


9 


cfg-cust-tree 


NEW 




10 


fgui-context 


default 




11 


fgui-base-dir 


_HOME_\code 


P" 


12 


fgui-collection 


testme 




13 


fgui-role 


developer 




14 


fgui-timeset 


default 


si 


15 


prev-coll 


c-myprogram 


23. C 


16 


old 


my-old-string 




17 


new 


my-new-string 


is* 


18 


files 


"filenamel filename2 ... filename3.txt" 
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FIG. 16 

1 name-dialog.tbl: 

2 # dialogs and their definition files 

3 # 

4 d-coll-select d-coll-select.def 

5 d-coll-rename d-coll-rename.def 

6 d-find-and-replace d-find-and-replace.def 



FIG. 17 

1 d-coll-select.def: 

2 # dialog for selecting a collection from a list 

3 # 

4 dialog d-coll-select 

5 dialog-title Select Collection 

6 # 

7 # define a text box to store coll name in a variable 

8 textbox coll-name 

9 textbox-title "Select A Collection" 

10 # 

1 1 # generate a dynamic list of colls to select from 

12 textbox-list-type list-dynamic 

13 textbox-list-xcmd "listcolls -r" 

1 4 textbox-list-label "List of collections to select from:" 

15 # 

16 # a non-null answer is required from the user 

17 textbox-text-required yes 

18 # 

1 9 # store the selection result in this variable name 

20 textbox-var-name var-selected-coll 

21 # 

22 ... other dialog attributes as desired 

23 end-dialog 
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1 name-list.tbl: 

2 # example lists and their definition files 

3 # 

4 list-projects list-projects.def 

5 list-personnel list-personnel.def 



6 
7 
8 
9 
10 
11 



list-projects.def: 

# list of projects at this site 



# display-name 
# 

"Admin Systems" 
"Network Upgrade" 



12 list-personnel.def : 

13 # list of employees 

14 # display-name 

15 Tom 

16 Joe 

17 Susan 



return-value 

proj-admin-sys 
proj-net-upgrade 



return-value 

torn 

joe 

susan 
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a-coll-select-and-install.def: 

# action def for selecting a coll, building it, and installing it 
# 



action 

action-desc 

action-type 

action-cmd-iname 

action-cmd-aname 

action-cmd-aname 

end-action 



a-coll-select-and-install 

select, build, and install a collection 

group 

callback-mult-commands 

a-coll-select 

a-coll-build-and-install 
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1 


a-coll.def: 




2 


# action definitions for working with collections 


3 


# 




4 


action 


a-coll-select 


5 


action-desc 


select a collection from a list of collections 


6 


action-type 


single 


7 


action-iname 


callback-collection-open 


8 


end-action 




9 


# 




10 


action 


a-coll-build-and-install 


11 


action-desc 


create makefile, build, and install a program 


12 


action-type 


single 


13 


action-cmd-iname 


callback-platform 


14 


action-cmd-xtext 


"makefilemagic — outfile makefile" 


15 


action-cmd-xtext 


"make all" 


16 


action-cmd-xtext 


"make install" 


17 


end-action 
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a-coll.def: 

# an example parallel single action with parallel external commands 
# 

a-single-parallel 

run three makefile targets in parallel 
single 

callback-platform 
"make target-one" 
"make target-two" 
"make target-three" 



action 
action-desc 
action-type 
action-cmd-iname 
action-pcmd-xtext 
action-pcmd-xtext 
action-pcmd-xtext 
end-action 



FIG. 22 



1 a-coll.def: 

2 # an example parallel single action with a mixed combination 

3 # of sequential and parallel external commands 

4 # 

5 action a-single-parallel 

6 action-desc run three makefile targets in parallel 

7 action-type single 

8 action-cmd-iname callback-platform 

9 # 

1 0 # execute this command by itself 

11 action-cmd-xtext "command 1" 

12 # 

1 3 # execute the next two commands in parallel 

14 action-pcmd-xtext "command 2" 

15 action-pcmd-xtext "command 3" 

16 # 

1 7 # execute the next command by itself 

18 action-cmd-xtext "command 4" 

19 # 

20 end-action 
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1 


a-coll.def: 




2 


# an example parallel single action with a sequence of 




3 


# parallel execution blocks separated by a wait command 




4 


# 




5 


action a-single-parallel 




6 


action-desc run 2 blocks of 2 commands in parallel 




7 


action-type single 




8 


action-cmd-iname callback-platform 




9 


# 


i 


10 


# execute the next two commands in parallel 




11 


action-pcmd-xtext "command 2" 


□ 


12 


action-pcmd-xtext "command 3" 




13 


# 




14 


# wait for the previous execution block to finish 




15 


action-pcmd-wait 




16 


# 




17 


# execute the next two commands in parallel 


y 


18 


action-pcmd-xtext "command 2" 


3 


19 


action-pcmd-xtext "command 3" 


11 


20 


# 


□ 


21 


end-action 
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1 a-actions-parallel.def: 

2 # an example parallel group action for building multiple programs 

3 # 

4 action a-build-group-one-programs 

5 action-desc build several programs in parallel 

6 action-type group 

7 action-cmd-iname callback-mult-commands 

8 action-pcmd-aname a-build-group-one 

9 action-pcmd-aname a-build-group-two 
10 end-action 
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1 a-actions-parallel.def: 

2 # an example parallel group action containing an interleaved sequence 
r ^ 3 # of single actions to be executed in sequence and in parallel 

O 4 # 

Jfj 5 action a-build-group-one-programs 

6 action-desc build several programs in parallel 

7 action-type group 

8 action-cmd-iname callback-mult-commands 

9 # 

1 0 # execute this single action by itself 

1 1 action-cmd-aname a-single-action-1 

12 # 

1 3 # execute the next two single actions in parallel 

1 4 action-pcmd-aname a-single-action-2 

1 5 action-pcmd-aname a-single-action-3 

16 # 

1 7 # execute the next single action by itself 

1 8 action-cmd-aname a-single-action-4 

19 # 

20 end-action 



+ 
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1 a-actions-parallel.def: 

2 # an example parallel group action containing a sequence 

3 # of parallel execution blocks separated by a wait command 

4 # 

5 action a-build-group-one-programs 

6 action-desc build several programs in parallel 
U 7 action-type group 

q 8 action-cmd-iname callback-mult-commands 

b 9 # 

p 1 0 # execute the next two single actions in parallel 

y 1 1 action-pcmd-aname a-single-action-2 

S C 12 action-pcmd-aname a-single-action-3 

III 13 # 

1^ 1 4 # wait for the previous parallel execution block to finish 

15 action-pcmd-wait 

•N 16 # 

I U 1 7 # execute the next two single actions in parallel 

y 18 action-pcmd-aname a-single-action-2 

!*J 19 action-pcmd-aname a-single-action-3 

y 20 # 

21 end-action 



